home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 1999 August / SGI Freeware 1999 August.iso / dist / fw_qt.idb / usr / freeware / catman / p_man / cat3 / qimageio.Z / qimageio
Encoding:
Text File  |  1998-10-28  |  22.5 KB  |  397 lines
  1.  
  2.  
  3.  
  4.      QQQQIIIImmmmaaaaggggeeeeIIIIOOOO((((3333qqqqtttt))))    TTTTrrrroooollllllll TTTTeeeecccchhhh AAAASSSS ((((9999 JJJJuuuullllyyyy 1111999999998888))))     QQQQIIIImmmmaaaaggggeeeeIIIIOOOO((((3333qqqqtttt))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.       QImageIO - Parameters    for loading and    saving images
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.       #include <qimage.h>
  13.  
  14.     PPPPuuuubbbblllliiiicccc MMMMeeeemmmmbbbbeeeerrrrssss
  15.       QQQQIIIImmmmaaaaggggeeeeIIIIOOOO (((())))
  16.       QQQQIIIImmmmaaaaggggeeeeIIIIOOOO (((( QQQQIIIIOOOODDDDeeeevvvviiiicccceeee **** _i_o_D_e_v_i_c_e,,,, ccccoooonnnnsssstttt cccchhhhaaaarrrr ****    ffffoooorrrrmmmmaaaatttt ))))
  17.       QQQQIIIImmmmaaaaggggeeeeIIIIOOOO (((( ccccoooonnnnsssstttt cccchhhhaaaarrrr    **** _f_i_l_e_N_a_m_e,,,, ccccoooonnnnsssstttt cccchhhhaaaarrrr **** ffffoooorrrrmmmmaaaatttt    ))))
  18.       ~~~~QQQQIIIImmmmaaaaggggeeeeIIIIOOOO ()
  19.       ccccoooonnnnsssstttt    QQQQIIIImmmmaaaaggggeeee&&&&    iiiimmmmaaaaggggeeee (((()))) ccccoooonnnnsssstttt
  20.       iiiinnnntttt ssssttttaaaattttuuuussss (((())))    ccccoooonnnnsssstttt
  21.       ccccoooonnnnsssstttt    cccchhhhaaaarrrr**** ffffoooorrrrmmmmaaaatttt (((())))    ccccoooonnnnsssstttt
  22.       QQQQIIIIOOOODDDDeeeevvvviiiicccceeee**** iiiiooooDDDDeeeevvvviiiicccceeee (((()))) ccccoooonnnnsssstttt
  23.       ccccoooonnnnsssstttt    cccchhhhaaaarrrr**** ffffiiiilllleeeeNNNNaaaammmmeeee (((()))) ccccoooonnnnsssstttt
  24.       ccccoooonnnnsssstttt    cccchhhhaaaarrrr**** ppppaaaarrrraaaammmmeeeetttteeeerrrrssss (((()))) ccccoooonnnnsssstttt
  25.       ccccoooonnnnsssstttt    cccchhhhaaaarrrr**** ddddeeeessssccccrrrriiiippppttttiiiioooonnnn (((()))) ccccoooonnnnsssstttt
  26.       vvvvooooiiiidddd sssseeeettttIIIImmmmaaaaggggeeee    (((( ccccoooonnnnsssstttt    QQQQIIIImmmmaaaaggggeeee &&&& ))))
  27.       vvvvooooiiiidddd sssseeeettttSSSSttttaaaattttuuuussss (((( iiiinnnntttt ))))
  28.       vvvvooooiiiidddd sssseeeettttFFFFoooorrrrmmmmaaaatttt (((( ccccoooonnnnsssstttt cccchhhhaaaarrrr ****    ))))
  29.       vvvvooooiiiidddd sssseeeettttIIIIOOOODDDDeeeevvvviiiicccceeee (((( QQQQIIIIOOOODDDDeeeevvvviiiicccceeee **** ))))
  30.       vvvvooooiiiidddd sssseeeettttFFFFiiiilllleeeeNNNNaaaammmmeeee (((( ccccoooonnnnsssstttt cccchhhhaaaarrrr    **** ))))
  31.       vvvvooooiiiidddd sssseeeettttPPPPaaaarrrraaaammmmeeeetttteeeerrrrssss (((( ccccoooonnnnsssstttt cccchhhhaaaarrrr **** ))))
  32.       vvvvooooiiiidddd sssseeeettttDDDDeeeessssccccrrrriiiippppttttiiiioooonnnn ((((    ccccoooonnnnsssstttt cccchhhhaaaarrrr **** ))))
  33.       bbbboooooooollll rrrreeeeaaaadddd (((())))
  34.       bbbboooooooollll wwwwrrrriiiitttteeee (((())))
  35.  
  36.     SSSSttttaaaattttiiiicccc PPPPuuuubbbblllliiiicccc MMMMeeeemmmmbbbbeeeerrrrssss
  37.       ccccoooonnnnsssstttt    cccchhhhaaaarrrr**** iiiimmmmaaaaggggeeeeFFFFoooorrrrmmmmaaaatttt (((( ccccoooonnnnsssstttt cccchhhhaaaarrrr **** ffffiiiilllleeeeNNNNaaaammmmeeee ))))
  38.       ccccoooonnnnsssstttt    cccchhhhaaaarrrr**** iiiimmmmaaaaggggeeeeFFFFoooorrrrmmmmaaaatttt (((( QQQQIIIIOOOODDDDeeeevvvviiiicccceeee ****    ))))
  39.       QQQQSSSSttttrrrrLLLLiiiisssstttt iiiinnnnppppuuuuttttFFFFoooorrrrmmmmaaaattttssss    (((())))
  40.       QQQQSSSSttttrrrrLLLLiiiisssstttt oooouuuuttttppppuuuuttttFFFFoooorrrrmmmmaaaattttssss (((())))
  41.       vvvvooooiiiidddd ddddeeeeffffiiiinnnneeeeIIIIOOOOHHHHaaaannnnddddlllleeeerrrr (((( ccccoooonnnnsssstttt cccchhhhaaaarrrr **** _f_o_r_m_a_t,,,, ccccoooonnnnsssstttt cccchhhhaaaarrrr ****
  42.           _h_e_a_d_e_r,,,, ccccoooonnnnsssstttt cccchhhhaaaarrrr **** _f_l_a_g_s
  43.  
  44.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  45.       The QImageIO class contains parameters for loading and
  46.       saving images.
  47.  
  48.       QImageIO contains a QIODevice    object that is used for    image
  49.       data I/O. The    programmer can install new image file formats
  50.       in addition to those that Qt implements.
  51.  
  52.       Qt currently supports    the following image file formats: GIF
  53.       (reading only), BMP, XBM, XPM    and PNM. The different PNM
  54.       formats are: PBM (P1), PGM (P2), PPM (P3), PBMRAW (P4),
  55.       PGMRAW (P5) and PPMRAW (P6).
  56.  
  57.       Additional formats are available with    the Qt Image IO
  58.       Extension package.
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                         (printed 9/22/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      QQQQIIIImmmmaaaaggggeeeeIIIIOOOO((((3333qqqqtttt))))    TTTTrrrroooollllllll TTTTeeeecccchhhh AAAASSSS ((((9999 JJJJuuuullllyyyy 1111999999998888))))     QQQQIIIImmmmaaaaggggeeeeIIIIOOOO((((3333qqqqtttt))))
  71.  
  72.  
  73.  
  74.       You will normally not    need to    use this class,
  75.       QPixmap::load(), QPixmap::save() and QImage contain most of
  76.       the needed functionality.
  77.  
  78.       For image files which    contain    sequences of images, only the
  79.       first    is read. See the QMovie    for loading multiple images.
  80.  
  81.       PBM, PGM, and    PPM format output is only supported in PPMRAW
  82.       format.
  83.  
  84.       WWWWaaaarrrrnnnniiiinnnngggg:::: Unisys has changed its position regarding GIF. If
  85.       you are in a country where Unisys holds a patent on LZW
  86.       compression and/or decompression, Unisys may require you to
  87.       license that technology. These countries include Canada,
  88.       Japan, the USA, France, Germany, Italy and the UK. There is
  89.       more information on Unisys web site: Overview    of Unisys'
  90.       position. GIF    support    may be removed in a future version of
  91.       Qt. We recommend using the PNG format, which is available in
  92.       the Qt Image IO Extension package.
  93.  
  94.       See also: QImage, QPixmap, QFile and QMovie.
  95.  
  96.      MMMMEEEEMMMMBBBBEEEERRRR FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNN DDDDOOOOCCCCUUUUMMMMEEEENNNNTTTTAAAATTTTIIIIOOOONNNN
  97.      QQQQIIIImmmmaaaaggggeeeeIIIIOOOO::::::::QQQQIIIImmmmaaaaggggeeeeIIIIOOOO    (((())))
  98.       Constructs a QImageIO    object with all    parameters set to
  99.       zero.
  100.  
  101.      QQQQIIIImmmmaaaaggggeeeeIIIIOOOO::::::::QQQQIIIImmmmaaaaggggeeeeIIIIOOOO    (((( QQQQIIIIOOOODDDDeeeevvvviiiicccceeee **** iiiiooooDDDDeeeevvvviiiicccceeee,,,,    ccccoooonnnnsssstttt cccchhhhaaaarrrr **** ffffoooorrrrmmmmaaaatttt ))))
  102.       Constructs a QImageIO    object with an I/O device and a    format
  103.       tag.
  104.  
  105.      QQQQIIIImmmmaaaaggggeeeeIIIIOOOO::::::::QQQQIIIImmmmaaaaggggeeeeIIIIOOOO    (((( ccccoooonnnnsssstttt    cccchhhhaaaarrrr **** ffffiiiilllleeeeNNNNaaaammmmeeee,,,, ccccoooonnnnsssstttt cccchhhhaaaarrrr **** ffffoooorrrrmmmmaaaatttt ))))
  106.       Constructs a QImageIO    object with a file name    and a format
  107.       tag.
  108.  
  109.      QQQQIIIImmmmaaaaggggeeeeIIIIOOOO::::::::~~~~QQQQIIIImmmmaaaaggggeeeeIIIIOOOO (((())))
  110.       Destroys the object an all related data.
  111.  
  112.      vvvvooooiiiidddd QQQQIIIImmmmaaaaggggeeeeIIIIOOOO::::::::ddddeeeeffffiiiinnnneeeeIIIIOOOOHHHHaaaannnnddddlllleeeerrrr (((( ccccoooonnnnsssstttt cccchhhhaaaarrrr **** ffffoooorrrrmmmmaaaatttt,,,, ccccoooonnnnsssstttt cccchhhhaaaarrrr
  113.       **** hhhheeeeaaaaddddeeeerrrr,,,, ccccoooonnnnsssstttt cccchhhhaaaarrrr **** ffffllllaaaaggggssss,,,,    iiiimmmmaaaaggggeeee____iiiioooo____hhhhaaaannnnddddlllleeeerrrr rrrreeeeaaaadddd____iiiimmmmaaaaggggeeee,,,,
  114.       iiiimmmmaaaaggggeeee____iiiioooo____hhhhaaaannnnddddlllleeeerrrr wwwwrrrriiiitttteeee____iiiimmmmaaaaggggeeee )))) [[[[ssssttttaaaattttiiiicccc]]]]
  115.       Defines a image IO handler for a specified image format. An
  116.       image    IO handler is responsible for reading and writing
  117.       images.
  118.  
  119.       Arguments:
  120.  
  121.       _f_o_r_m_a_t is the    name of    the format.
  122.  
  123.       _h_e_a_d_e_r is a regular expression that recognizes the image header.
  124.  
  125.      to    use 0.
  126.  
  127.  
  128.  
  129.      Page 2                         (printed 9/22/98)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      QQQQIIIImmmmaaaaggggeeeeIIIIOOOO((((3333qqqqtttt))))    TTTTrrrroooollllllll TTTTeeeecccchhhh AAAASSSS ((((9999 JJJJuuuullllyyyy 1111999999998888))))     QQQQIIIImmmmaaaaggggeeeeIIIIOOOO((((3333qqqqtttt))))
  137.  
  138.  
  139.  
  140.       _f_l_a_g_s    is "T" for text    formats    like PBM; generally you    will want
  141.  
  142.       _r_e_a_d__i_m_a_g_e is    a function to read an image of this format.
  143.  
  144.      read_image    and write_image    are of type image_io_handler, which is
  145.      a function    pointer.
  146.       _w_r_i_t_e__i_m_a_g_e is a function to write an    image of this format. Both
  147.  
  148.       Example:
  149.  
  150.           void readGIF( QImageIO *image )
  151.           {
  152.         // read    the image, using the image->ioDevice()
  153.           }
  154.           void writeGIF( QImageIO *image )
  155.           {
  156.         // write the image, using the image->ioDevice()
  157.           }
  158.           // add the GIF image handler
  159.           QImageIO::defineIOHandler( "GIF",
  160.                      "^GIF[0-9][0-9][a-z]",
  161.                      0,
  162.                      readGIF,
  163.                      writeGIF );
  164.  
  165.       For image formats supporting incremental display, such as
  166.       sequences of animated    frames,    see the    QImageFormatType
  167.       class.
  168.  
  169.      ccccoooonnnnsssstttt cccchhhhaaaarrrr    **** QQQQIIIImmmmaaaaggggeeeeIIIIOOOO::::::::ddddeeeessssccccrrrriiiippppttttiiiioooonnnn    (((()))) ccccoooonnnnsssstttt
  170.       Returns the image description    string.
  171.  
  172.       See also: setDescription().
  173.  
  174.      ccccoooonnnnsssstttt cccchhhhaaaarrrr    **** QQQQIIIImmmmaaaaggggeeeeIIIIOOOO::::::::ffffiiiilllleeeeNNNNaaaammmmeeee (((())))    ccccoooonnnnsssstttt
  175.       Returns the file name    currently set.
  176.  
  177.       See also: setFileName().
  178.  
  179.      ccccoooonnnnsssstttt cccchhhhaaaarrrr    **** QQQQIIIImmmmaaaaggggeeeeIIIIOOOO::::::::ffffoooorrrrmmmmaaaatttt (((()))) ccccoooonnnnsssstttt
  180.       Returns the image format string, or 0    if no format has been
  181.       explicitly set.
  182.  
  183.      ccccoooonnnnsssstttt QQQQIIIImmmmaaaaggggeeee &&&& QQQQIIIImmmmaaaaggggeeeeIIIIOOOO::::::::iiiimmmmaaaaggggeeee (((()))) ccccoooonnnnsssstttt
  184.       Returns the image currently set.
  185.  
  186.       See also: setImage().
  187.  
  188.      ccccoooonnnnsssstttt cccchhhhaaaarrrr    **** QQQQIIIImmmmaaaaggggeeeeIIIIOOOO::::::::iiiimmmmaaaaggggeeeeFFFFoooorrrrmmmmaaaatttt    (((( QQQQIIIIOOOODDDDeeeevvvviiiicccceeee **** dddd    )))) [[[[ssssttttaaaattttiiiicccc]]]]
  189.       Returns a string that    specifies the image format of the
  190.       image    read from _d, or    null if    the file cannot    be read    or if
  191.       the format is    not recognized.
  192.  
  193.  
  194.  
  195.      Page 3                         (printed 9/22/98)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      QQQQIIIImmmmaaaaggggeeeeIIIIOOOO((((3333qqqqtttt))))    TTTTrrrroooollllllll TTTTeeeecccchhhh AAAASSSS ((((9999 JJJJuuuullllyyyy 1111999999998888))))     QQQQIIIImmmmaaaaggggeeeeIIIIOOOO((((3333qqqqtttt))))
  203.  
  204.  
  205.  
  206.      ccccoooonnnnsssstttt cccchhhhaaaarrrr    **** QQQQIIIImmmmaaaaggggeeeeIIIIOOOO::::::::iiiimmmmaaaaggggeeeeFFFFoooorrrrmmmmaaaatttt    (((( ccccoooonnnnsssstttt    cccchhhhaaaarrrr **** ffffiiiilllleeeeNNNNaaaammmmeeee    ))))
  207.       [[[[ssssttttaaaattttiiiicccc]]]]
  208.       Returns a string that    specifies the image format of the file
  209.       _f_i_l_e_N_a_m_e, or null if the file    cannot not be read or if the
  210.       format is not    recognized.
  211.  
  212.      QQQQSSSSttttrrrrLLLLiiiisssstttt QQQQIIIImmmmaaaaggggeeeeIIIIOOOO::::::::iiiinnnnppppuuuuttttFFFFoooorrrrmmmmaaaattttssss (((())))    [[[[ssssttttaaaattttiiiicccc]]]]
  213.       Returns a sorted list    of image formats which are supported
  214.       for image input.
  215.  
  216.      QQQQIIIIOOOODDDDeeeevvvviiiicccceeee **** QQQQIIIImmmmaaaaggggeeeeIIIIOOOO::::::::iiiiooooDDDDeeeevvvviiiicccceeee (((()))) ccccoooonnnnsssstttt
  217.       Returns the IO device    currently set.
  218.  
  219.       See also: setIODevice().
  220.  
  221.      QQQQSSSSttttrrrrLLLLiiiisssstttt QQQQIIIImmmmaaaaggggeeeeIIIIOOOO::::::::oooouuuuttttppppuuuuttttFFFFoooorrrrmmmmaaaattttssss (((()))) [[[[ssssttttaaaattttiiiicccc]]]]
  222.       Returns a sorted list    of image formats which are supported
  223.       for image output.
  224.  
  225.      ccccoooonnnnsssstttt cccchhhhaaaarrrr    **** QQQQIIIImmmmaaaaggggeeeeIIIIOOOO::::::::ppppaaaarrrraaaammmmeeeetttteeeerrrrssss (((()))) ccccoooonnnnsssstttt
  226.       Returns image    parameters string.
  227.  
  228.       See also: setParameters().
  229.  
  230.      bbbboooooooollll QQQQIIIImmmmaaaaggggeeeeIIIIOOOO::::::::rrrreeeeaaaadddd (((())))
  231.       Reads    an image into memory and returns TRUE if the image was
  232.       successfully read.
  233.  
  234.       Before reading an image, you must set    an IO device or    a file
  235.       name.    If both    an IO device and a file    name has been set,
  236.       then the IO device will be used.
  237.  
  238.       Setting the image file format    string is optional.
  239.  
  240.       Note that this function does _n_o_t set the format used to read
  241.       the image. If    you need that information, use the
  242.       imageFormat()    static functions.
  243.  
  244.       Example:
  245.  
  246.           QImageIO iio;
  247.           QPixmap  pixmap;
  248.           iio.setFileName( "burger.bmp" );
  249.           if ( image.read()    )          // ok
  250.           pixmap = iio.image();          // convert to    pixmap
  251.  
  252.       See also: setIODevice(), setFileName(), setFormat(), write()
  253.       and QPixmap::load().
  254.  
  255.      vvvvooooiiiidddd QQQQIIIImmmmaaaaggggeeeeIIIIOOOO::::::::sssseeeettttDDDDeeeessssccccrrrriiiippppttttiiiioooonnnn (((( ccccoooonnnnsssstttt cccchhhhaaaarrrr    **** ddddeeeessssccccrrrriiiippppttttiiiioooonnnn ))))
  256.       Sets the image description string for    image handlers that
  257.       support image    descriptions.
  258.  
  259.  
  260.  
  261.      Page 4                         (printed 9/22/98)
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.      QQQQIIIImmmmaaaaggggeeeeIIIIOOOO((((3333qqqqtttt))))    TTTTrrrroooollllllll TTTTeeeecccchhhh AAAASSSS ((((9999 JJJJuuuullllyyyy 1111999999998888))))     QQQQIIIImmmmaaaaggggeeeeIIIIOOOO((((3333qqqqtttt))))
  269.  
  270.  
  271.  
  272.       Currently, no    image format supported by Qt use the
  273.       description string.
  274.  
  275.      vvvvooooiiiidddd QQQQIIIImmmmaaaaggggeeeeIIIIOOOO::::::::sssseeeettttFFFFiiiilllleeeeNNNNaaaammmmeeee    (((( ccccoooonnnnsssstttt    cccchhhhaaaarrrr **** ffffiiiilllleeeeNNNNaaaammmmeeee    ))))
  276.       Sets the name    of the file to read or write an    image.
  277.  
  278.       See also: setIODevice().
  279.  
  280.      vvvvooooiiiidddd QQQQIIIImmmmaaaaggggeeeeIIIIOOOO::::::::sssseeeettttFFFFoooorrrrmmmmaaaatttt ((((    ccccoooonnnnsssstttt cccchhhhaaaarrrr **** ffffoooorrrrmmmmaaaatttt ))))
  281.       Sets the image format    name of    the image about    to be read or
  282.       written.
  283.  
  284.       It is    necessary to specify a format before writing an    image.
  285.  
  286.       It is    not necessary to specify a format before reading an
  287.       image. If not    format has been    set, Qt    guesses    the image
  288.       format before    reading    it. If a format    is set,    but the    image
  289.       has another (valid) format, the image    will not be read.
  290.  
  291.       See also: read(), write() and    format().
  292.  
  293.      vvvvooooiiiidddd QQQQIIIImmmmaaaaggggeeeeIIIIOOOO::::::::sssseeeettttIIIIOOOODDDDeeeevvvviiiicccceeee    (((( QQQQIIIIOOOODDDDeeeevvvviiiicccceeee **** iiiiooooDDDDeeeevvvviiiicccceeee ))))
  294.       Sets the IO device to    be used    for reading or writing an
  295.       image.
  296.  
  297.       Setting the IO device    allows images to be read/written to
  298.       any block-oriented QIODevice.
  299.  
  300.       If _i_o_D_e_v_i_c_e is not null, this    IO device will override    file
  301.       name settings.
  302.  
  303.       See also: setFileName().
  304.  
  305.      vvvvooooiiiidddd QQQQIIIImmmmaaaaggggeeeeIIIIOOOO::::::::sssseeeettttIIIImmmmaaaaggggeeee (((( ccccoooonnnnsssstttt QQQQIIIImmmmaaaaggggeeee &&&& iiiimmmmaaaaggggeeee ))))
  306.       Sets the image.
  307.  
  308.       See also: image().
  309.  
  310.      vvvvooooiiiidddd QQQQIIIImmmmaaaaggggeeeeIIIIOOOO::::::::sssseeeettttPPPPaaaarrrraaaammmmeeeetttteeeerrrrssss (((( ccccoooonnnnsssstttt cccchhhhaaaarrrr **** ppppaaaarrrraaaammmmeeeetttteeeerrrrssss ))))
  311.       Sets the image parameters string for image handlers that
  312.       require special parameters.
  313.  
  314.       Although all image formats supported by Qt ignore the
  315.       parameters string, it    will be    useful for future extentions
  316.       or contributions (like JPEG).
  317.  
  318.      vvvvooooiiiidddd QQQQIIIImmmmaaaaggggeeeeIIIIOOOO::::::::sssseeeettttSSSSttttaaaattttuuuussss ((((    iiiinnnntttt ssssttttaaaattttuuuussss ))))
  319.       Sets the image IO status. A non-zero value indicates an
  320.       error, while 0 means that the    IO operation was successful.
  321.  
  322.       See also: status().
  323.  
  324.  
  325.  
  326.  
  327.      Page 5                         (printed 9/22/98)
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.      QQQQIIIImmmmaaaaggggeeeeIIIIOOOO((((3333qqqqtttt))))    TTTTrrrroooollllllll TTTTeeeecccchhhh AAAASSSS ((((9999 JJJJuuuullllyyyy 1111999999998888))))     QQQQIIIImmmmaaaaggggeeeeIIIIOOOO((((3333qqqqtttt))))
  335.  
  336.  
  337.  
  338.      iiiinnnntttt QQQQIIIImmmmaaaaggggeeeeIIIIOOOO::::::::ssssttttaaaattttuuuussss (((()))) ccccoooonnnnsssstttt
  339.       Returns the image IO status. A non-zero value    indicates an
  340.       error, while 0 means that the    IO operation was successful.
  341.  
  342.       See also: setStatus().
  343.  
  344.      bbbboooooooollll QQQQIIIImmmmaaaaggggeeeeIIIIOOOO::::::::wwwwrrrriiiitttteeee (((())))
  345.       Writes an image to an    IO device and returns TRUE if the
  346.       image    was successfully written.
  347.  
  348.       Before writing an image, you must set    an IO device or    a file
  349.       name.    If both    an IO device and a file    name has been set,
  350.       then the IO device will be used.
  351.  
  352.       The image will be written using the specified    image format.
  353.  
  354.       Example:
  355.  
  356.           QImageIO iio;
  357.           QImage   im;
  358.           im = pixmap;                  // convert to    image
  359.           iio.setImage( im );
  360.           iio.setFileName( "burger.bmp" );
  361.           iio.setFormat( "BMP" );
  362.           iio.write();                  // TRUE if ok
  363.  
  364.       See also:  setIODevice(), setFileName(), setFormat(),    read()
  365.       and QPixmap::save().
  366.  
  367.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  368.       hhhhttttttttpppp::::////////wwwwwwwwwwww....ttttrrrroooollllllll....nnnnoooo////qqqqtttt////qqqqiiiimmmmaaaaggggeeeeiiiioooo....hhhhttttmmmmllll
  369.  
  370.      CCCCOOOOPPPPYYYYRRRRIIIIGGGGHHHHTTTT
  371.       Copyright 1992-1997 Troll Tech AS.  See the LICENSE file
  372.       included in the distribution for a complete license
  373.       statement.
  374.  
  375.      AAAAUUUUTTTTHHHHOOOORRRR
  376.       Generated automatically from the source code.
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.      Page 6                         (printed 9/22/98)
  394.  
  395.  
  396.  
  397.